home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / gfx / pbm / source1.lha / netpbm / README.VMS < prev    next >
Text File  |  1994-02-25  |  7KB  |  131 lines
  1.                                                              25-FEB-1994
  2.     Hi VAX/VMS and future PBMplus users!!!
  3.  
  4.         This version of Jef Poskanzer's PBMplus package is ready-made to
  5.     support the DEC VAX/VMS C environment.  In an attempt to make it run
  6.     like the Unix environment, the  programs  have been modified to look
  7.     like they use the "piping" and  "redirection"  features  of Unix and
  8.     MSDOS.  In this way, the documentation  and  other people's comments
  9.     (i.e.,  USENET  alt.graphics.pixutils discussions, etc.) will be the
  10.     same for all platforms.
  11.  
  12.         This  VMS  implementation  borrows  heavily  from  the  previous
  13.     PBMplus/VMS release  by  Rick Dyson for 10dec91 which in turn builds
  14.     on the work  Terry  Poot (tp@mccall.com) did for the 05feb91 general
  15.     release of PBMplus.   Many thanks and credits go his direction.  The
  16.     "piping/redirection"    is    attributed    to    Mark     Pizzolato
  17.     (mark@infopiz.uucp).  The creation of the  shareable  library is due
  18.     to work done by Dave Jones (JONESD@kcgl1.eng.ohio-state.edu).
  19.  
  20.         Well, since you are reading this, I  guess  you have the PBMplus
  21.     kit and have broken it out into it's  respective  directories.    At
  22.     this  point you just have to start the build  operation.    In  this
  23.     release  of the PBMplus package the process is much easier  than  in
  24.     the past.  There is no patching of the source code necessary  and so
  25.     there is no  extra  "patch-build kit".  This contains everything you
  26.     need to build the PBMplus package.
  27.     
  28.         There is only one step to the preparation process and that is to
  29.     copy  all the files from the [.VMS] sub-directory up one level  into
  30.     the  root  [PBMplus]  directory.
  31.  
  32. "MAKEFILE.MMS"
  33. -------------
  34.         There are  two  methods  of building the executables.  The first
  35.     (and prefered) method  uses DECs "makefile" utility, MMS, which uses
  36.     the "MAKEFILE.MMS" files.   If  you  don't  have  MMS,  skip  to the
  37.     section labeled "MAKE_PBMPLUS.COM" below.  If you are still with me,
  38.     just  type  "MMS  /Description  =  Makefile.MMS"    and  follow  the
  39.     directions outlined on the screen.  Your most probable sequence will
  40.     be the something like the following:
  41.  
  42. $ MMS /Description = Makefile.MMS ALL
  43. $ MMS /Description = Makefile.MMS INSTALL   ! creates & loads [.Exe]
  44. $ MMS /Description = Makefile.MMS HELP      ! make PBMPLUS.HLB
  45. $ MMS /Description = Makefile.MMS MANUAL    ! will need LaTeX and tr2TeX...
  46. $ MMS /Description = Makefile.MMS INSTALLMANUAL ! creates & loads [.TeX]
  47. $ MMS /Description = Makefile.MMS CLEAN     ! clean up all recoverable files
  48.  
  49.         The  available  choices  will  be  displayed  if you  don't  say
  50.     anything, i.e.
  51.  
  52.             $ MMS /Description = Makefile.MMS
  53.  
  54. "MAKE_PBMPLUS.COM"
  55. ------------------
  56.         The  other  method  of  building the package is to  execute  the
  57.     "MAKE_PBMPLUS.COM" command  procedure.    This was mostly created by
  58.     the "MMS BUILD_PROC"  command.    It  is not as flexible as MMS, but
  59.     should get the job done.  Look  through the procedure and edit it as
  60.     you see fit.  It builds and installs  just  about  everything, so it
  61.     might be in your best interest to look through  it and use your veto
  62.     powers to comment out the unneeded (or unavailable) parts.   Be sure
  63.     to look and check what you have before executing the procedure.
  64.  
  65. "SETUP.COM"
  66. -----------
  67.         I  have  provided  two  setup  files  with  this distribution to
  68.     facilitate  the  day-to-day use of PBMplus.  All you need to  do  is
  69.     execute  the  SETUP.COM  command  procedure and it will make all the
  70.     logical name  and  foreign  symbol  definitions.    You  should look
  71.     through SETUP.COM and  read  the  comments  about the rooted logical
  72.     names used.  After  all  that, look through the TeX documentation or
  73.     the on-line help files to get an idea of how to start using PBMplus.
  74.     
  75.         NOTE:    An  error  in  MMS will occur if you  have  used
  76.         SETUP.COM before  using  MMS.  A logical name conflict or
  77.         something.  Either  logout  and login to clear things out
  78.         or  Deassign PBMplus_Root and  PBMplus_Dir  before  using
  79.         MMS.
  80.     
  81. Manifest
  82. --------
  83.         The following files are included  with this VMS port of PBMplus.
  84.     The bare essential ones needed to complete the build are marked with
  85.     an astreisk (*):
  86.  
  87.         [.VMS]MAKEFILE.MMS     -- VMS MMS description file (i.e., "makefile")
  88.                                   for all of PBMplus
  89.        *[.VMS]MAKE_PBMPLUS.COM -- VMS command procedure produced by MMS to build
  90.                                   the PBMplus package for users without MMS
  91.        *[.VMS]MAKE_PBMPLUSSHR.COM -- VMS command procedure to build Shareable
  92.                                   link library of the four main PBMplus object
  93.                                   libraries; LIBPBM, LIBPGM, LIBPPM, & LIBPNM
  94.         [.VMS]SETUP.COM        -- An initialization/definition command proc for
  95.                                   "everyday use" of PBMplus once it's built
  96.         [.VMS]ADD_LIST.COM     -- Generic command procedure to add another
  97.                                   library to any VMS librarian list, (i.e.,
  98.                                   Hlp$Library_nn or Lnk$Library_nn)
  99.         [.VMS]PBMPLUS.HLP      -- VMS Help library file for all of PBMplus
  100.         [.PBM]MAKEFILE.MMS     -- VMS MMS description file for PBM routines
  101.         [.PGM]MAKEFILE.MMS     -- VMS MMS description file for PGM routines
  102.         [.PPM]MAKEFILE.MMS     -- VMS MMS description file for PPM routines
  103.         [.PNM]MAKEFILE.MMS     -- VMS MMS description file for PNM routines
  104.         [.LIBTIFF]MAKEFILE.MMS -- VMS MMS description file for LIBTIFF routines
  105.  
  106.         When it's all over and done, the  PBMplus  directory tree should
  107.     resemble  the following:
  108.  
  109.     PBMPLUS  ---+ EXE                           <-- the binaries
  110.                 |
  111.                 + LIBTIFF                       <-- TIFF library
  112.                 |
  113.                 + PBM                           <-- Portable BitMaps
  114.                 |
  115.                 + PGM                           <-- Portable Grayscale Maps
  116.                 |
  117.                 + PNM                           <-- Portable aNy Maps
  118.                 |
  119.                 + PPM                           <-- Portable Picture Maps
  120.                 |
  121.                 + VMS                           <-- VMS specific files
  122.  
  123. Rick Dyson
  124. --
  125. Richard L. Dyson               INTERNET:  Dyson@IowaSP.Physics.UIowa.EDU
  126.  _   _      _____    Senior Programmer Analyst          O: 319/335--1879
  127. | | | |    |_   _|   Department of Physics & Astronomy  H: 319/338--6117
  128. | | | | of   | |     Van Allen Hall            NSI/DECnet: IOWASP::DYSON
  129. | \_/ |     _| |_    University of Iowa               or :   7231::DYSON
  130.  \___/     |_____|   Iowa City, IA 52242-1479
  131.